home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / programming / other / guigfxlib / doc / history < prev    next >
Text File  |  1999-06-14  |  18KB  |  470 lines
  1.  
  2. history
  3. -------------------------
  4.  
  5. v16
  6.     - added GGFX_RastLock for passing an optional SignalSemaphore
  7.       that may be used for locking a drawhandle's rastport while
  8.       rendering.
  9.     
  10.     - default dithermode is now DITHERMODE_EDD.
  11.     
  12.     - v39 exec pooled memory environment reactivated (it was
  13.       disabled since v10).
  14.       
  15.     - added StormC includes.
  16.     
  17.     - removed all assembler and E includes. I'm too lazy to
  18.       keep the assembler files up-to-date manually, and the
  19.       iconvert tool of E throws enforcerhits on my system.
  20.       (if you're programming the respective languages, you
  21.       should have better ways to transform the includes than
  22.       I have)
  23.  
  24. v15.2
  25.     - static-palette drawhandles allocate much better pens now
  26.       (a YUV colorspace is used instead of RGB), and allocation
  27.       is quicker.
  28.  
  29. v15.1
  30.     - render.library crashed with an ILLEGAL exception
  31.       (caused by a memhandler leak) when a HAM picture
  32.       was loaded with a v42 ILBM datatype. fixed.
  33.     
  34.     - CreatePictureMask() failed to create scaled masks.
  35.       fixed.
  36.  
  37. v15
  38.     - added a few basic examples to the documentation.
  39.     - added GGFX_UseMask for LoadPicture(). if TRUE and supported
  40.       by the datatype, a mask will be read and included to the 
  41.       picture as an alpha-channel.
  42.     - new function: CreatePictureMask(). This function creates
  43.       a single-bitplane mask from a picture's alpha-channel. it
  44.       can be passed to graphics.library/BltMaskBitMapRastPort().
  45.     - CreatePictureBitMap() now accepts a NULL picture. This can
  46.       be used to allocate a blank bitmap that can be blitted
  47.       to a drawhandle efficiently.
  48.  
  49. v14
  50.     - minor bug in MakePicture() fixed: when a blank
  51.       picture was created (data = NULL), the independent
  52.       flag was internally not set to TRUE.
  53.     - PICMTHD_AUTOCROP cropped blank pictures down to zero
  54.       pixels - fixed. (oops! evil crashes :-)
  55.  
  56. v13
  57.     - minor internal changes
  58.  
  59. v12
  60.     - added picture method PICMTHD_AUTOCROP
  61.     - the includes did not contain the definitions for
  62.       PICMTHD_NEGATIVE. fixed.
  63.  
  64. v11
  65.     - the Tower JPEG codec is no longer supported directly.
  66.     - added documentation for the v9 directdraw functions.
  67.  
  68. v10.2
  69.     - env/usescalepixelarray is no longer considered for
  70.       CreatePictureBitMap(). this function always uses
  71.       internal scaling routines now.
  72.  
  73. v10.1
  74.     - fixed a semaphore lockup problem when MakePicture() failed due to
  75.       a lack of memory
  76.     - parts of the library have been restructured.
  77.     - internal bitmap handling rewritten.
  78.     - MakePicture() has been rewritten. lots of sanity checks have been added.
  79.       bitmap conversion is more efficient. scaling has been included.
  80.     - fixed DirectDrawTruecolor() on truecolor screens without scaling
  81.     - rewrote ReadPicture(), added tags GGFX_AspectX, GGFX_AspectY,
  82.       GGFX_DestWidth, GGFX_DestHeight, and GGFX_ModeID.
  83.     - added picture method PICMTHD_NEGATIVE
  84.  
  85. v10
  86.     - major stability update! thanks to Luca Longone, who encountered
  87.       MystiCube crashing when started multiple times. the internal
  88.       memory manager is now reset to RMHTYPE_PUBLIC, and no problems
  89.       occured with 4 mysticubes, 2 mysticviews in slideshow mode,
  90.       rgbplasma, plus viewworld running simultaneously for many hours
  91.       under heavy debugging conditions.
  92.  
  93.       public memory management seems to solve all outstanding problems,
  94.       but it causes more memory fragmentation. a more sophisticated
  95.       memory manager is being planned.
  96.  
  97.     - added documentation for Source-Tags in picture method
  98.       PICMTHD_MIXALPHA.
  99.  
  100. v9.0
  101.     - CreatePictureBitmap() now returns gently with a NULL pointer
  102.       when no valid picture or drawhandles were specified.
  103.     - added CreatePictureMask(). (experimental, not for public use yet)
  104.  
  105. v8.5
  106.     - added env variable AUTODITHERTHRESHOLD
  107.     - env variables are now considered only once, when the
  108.       library is opened.
  109.     - forgot to document PICMTHD_SET in the autodocs. fixed.
  110.     - added method PICMTHD_CHECKAUTODITHER.
  111.  
  112. v8.4
  113.     - GGFX_AutoDither is now considered by DrawPicture()
  114.  
  115.  
  116. v8.3
  117.     - fixed CreateDirectDrawHandle(). when the input and
  118.       output dimensions were the same, this function returned
  119.       NULL instead of a valid directdrawhandle.
  120.     
  121.     - added support for texture-mapping and rotating while
  122.       drawing (no additional buffers required). currently
  123.       not documented and for internal use only.
  124.     
  125.     - added env variable guigfx/USEWPA8. it is used when the
  126.       drawhandle is on a native Amiga screenmode. when set to
  127.       0, guigfx.library will use an internal c2p routine.
  128.       when set to 1, guigfx.library will call WritePixelArray8(),
  129.       WritePixelLine8() or WriteChunkyPixels().
  130.  
  131. v8.2
  132.     - 12bit (default) drawhandles now use mapping-engines for
  133.       optimized rendering to static palettes (no pen-sharemap
  134.       specified for ObtainDrawHandle()). this is preliminary,
  135.       for test purposes only.
  136.     
  137.     - fixed PICMTHD_INSERT to support insertion of pictures
  138.       which are both mapped to the same drawhandle. untested yet.
  139.  
  140. v8.1
  141.     - to end up problems with cybergraphics.library/ScalePixelArray(),
  142.       I've included an ENV variable named guigfx/USESCALEPIXELARRAY
  143.       so that the user may decide. Default is "0", and
  144.       guigfx.library/DrawPicture() uses its internal scaling
  145.       routines. DirectDrawTrueColor() always uses ScalePixelArray()
  146.       with cgfx v41 present.
  147.  
  148. v8.0
  149.     - added CreateDirectDrawHandle(), DeleteDirectDrawHandle()
  150.       and DirectDrawTrueColor() for optimized drawing of
  151.       RGB data.
  152.  
  153.     - wowsers, cybergraphics.library/scalepixelarray() seems
  154.       to get faster and buggier with every new cybergraphics
  155.       update. i wonder if the authors still know what's going
  156.       on inside? anyway, i can't really decide whether to use
  157.       it or not. currently, DirectDrawTrueColor() uses it for
  158.       higher performance, and DrawPicture() doesn't for
  159.       accurate scaling without flicker.
  160.  
  161. v7.2
  162.     - applied Tower JPEG Class license agreements to the
  163.       legal informations.
  164.  
  165.     - If you want to use the Tower JPEG codec, your program
  166.       has to be in accordance to the respective license
  167.       agreements. Specify the tag GGFX_License for
  168.       IsPicture() and LoadPicture() to use the JPEG codec.
  169.       Otherwise, datatypes are used.
  170.  
  171. v7.1
  172.     - added picture mehtods PICMTHD_FLIPX and PICMTHD_FLIPY.
  173.  
  174. v7.0
  175.     - added picture method PICMTHD_INSERT.
  176.  
  177. v6.2
  178.     - improved drawing speed with OS3.0
  179.  
  180. v6
  181.     - ClonePicture() now handles scaling.
  182.     - minor changes and speed improvements.
  183.     - JPEG is the first file format to be supported
  184.       directly. LoadPicture() uses the tower.library
  185.       JPEG codec if available. directly supported
  186.       formats require less memory while loading.
  187.  
  188. v5
  189.     - added method PICMTHD_TINTALPHA
  190.  
  191. v4.4
  192.     - since v4.3, ObtainDrawHandle() crashed on screens with
  193.       no sharable pens. fixed.
  194.     - if render.library cannot be found in LIBS:,
  195.       guigfx.library now tries to open it at libs/.
  196.     - IsPicture() no longer crashes without datatypes.library.
  197.  
  198. v4.3
  199.     - improved logic in ObtainDrawHandle() for
  200.       truecolor-rastports and pensharemap=NULL
  201.     - updated autodocs.
  202.     - Calls to ScalePixelArray()/cybergraphics v41 have been
  203.       removed. Instead, a 24bit render.library scaling-engine
  204.       is used. ScalePixelArray() is too slow (especially with
  205.       large images), does not scale correctly, causes
  206.       flickering, and cannot be interrupted.
  207.     - fixed PICMTHD_SET with pictures mapped to a drawhandle.
  208.     - added tags GGFX_SourceWidth, GGFX_SourceHeight, 
  209.       GGFX_SourceX und GGFX_SourceY to ClonePicture(). It's
  210.       now possible to clone a picture in part.
  211.     - fixed a minor bug in MakePicture().
  212.     - MakePicture() now accpets NULL as the palette argument
  213.       for PIXFMT_CHUNKY_CLUT, in which case a grey palette
  214.       with 256 entries will be generated.
  215.  
  216. v4.2
  217.     - DrawPicture() did not set a correct return value under
  218.       rare circumstances. fixed.
  219.     - pictures now cache their last scaling-engine.
  220.     - DrawPicture() is now guaranteed to execute the line hook
  221.       at least once per call.
  222.  
  223. v4.1
  224.     - the functions LockPicture() and UnlockPicture() are now
  225.       considered 'obsolete'. Calling LockPicture() will always
  226.       return FALSE, and UnlockPicture() will do nothing.
  227.       
  228.       Please remove these functions from your code and replace
  229.       them with a call to DoPictureMethod() with
  230.       PICMTHD_MAPDRAWHANDLE if you need optimized rendering.
  231.  
  232.       The idea behind LockPicture() wasn't too bad, but currently
  233.       it is not possible to implement it properly. LockPicture()
  234.       and UnlockPicture() will no longer be documented, but the
  235.       LVOs remain valid and might be reactivated some day. Calling
  236.       these functions in already existing code is harmless.
  237.  
  238. v4.00
  239.     - implemented IsPicture()
  240.  
  241. v3.11
  242.     - fixed several memory management problems with LoadPicture().
  243.  
  244. v3.10
  245.     - fixed a heavy bug leading to memory corruptions, especially
  246.       when drawing to native Amiga screen modes.
  247.     
  248. v3.03
  249.     - MakePictureA() now accepts NULL as a data pointer. This
  250.       will create a 'blank' picture with the specified
  251.       attributes.
  252.     - ObtainDrawHandleA() now accepts NULL for the pensharemap
  253.       argument. In this case ObtainDrawHandle creates a drawhandle
  254.       with a static 9bit colorspace palette.
  255.     - MakePictureA() now accepts a NULL palette for PIXFMT_CHUNKY_CLUT.
  256.       This will create a default-palette (256 colors from black to white)
  257.     - drawing to bitplanes without scaling is now performed
  258.       via Chunky2BitMap/BltBitMapRastPort.
  259.     - implemented PICMTHD_SET.
  260.     - fixed lots of bugs in internal picture conversion routines.
  261.  
  262. v3.02
  263.     - guigfx.library no longer depends on datatypes.library v40.
  264.       the minimum version number is reset to v39.
  265.     - implemented PICMTHD_TEXTURE.
  266.     - bumped revision number for render.library to v25.
  267.  
  268. v3.01
  269.     - fixed a minor bug in LockPictureA().
  270.     - added documentation for LockPictureA() and UnLockPicture().
  271.     - added a workaround for INVALID_ID originating from
  272.       PDTA_ModeID. INVALID_ID returned by a datatype appears
  273.       neither logical nor legal to me. anyway, guigfx.library
  274.       no longer crashes with HAM8 pictures loaded by the ILBM v43
  275.       datatype in an ECS/OCS environment. however, the images still
  276.       appear scrambled, since guigfx.library cannot determine whether
  277.       to treat an image as HAM8 or not.
  278.  
  279. v3.00
  280.     - Some more tags implemented.
  281.     - the autodocs have been reworked.
  282.     - the internal memhandler has been reset to RMHTYPE_POOL.
  283.     - implemented LockPicture() and UnlockPicture().
  284.     - color allocation strategy improved.
  285.     - datatypes.Library is no longer required for guigfx.library
  286.       to be opened successfully.
  287.  
  288. v2.01
  289.     - fixed GGFX_SourceX / GGFX_SourceY when drawing truecolor data to
  290.       truecolor rastports without scaling. Thanks to M. Hillenbrand
  291.       who reported this obstinate bug.
  292.  
  293. v2.00
  294.     - fixed some internal histogram-related quirks and problems.
  295.       the resolution of a picture's histogram is now by default the
  296.       pensharemap's resolution it is being added to. if no
  297.       pensharemap is involved, then the histogram's resolution
  298.       will be set to the default resolution (currently HSTYPE_12BIT_TURBO).
  299.       You may as well set GGFX_HSType for LoadPicture(), MakePicture(),
  300.       and ReadPicture(), but this is not required under normal
  301.       circumstances. Better set the desired resolution when calling
  302.       CreatePenShareMap().
  303.     - guigfx.library no longer crashes with old versions of
  304.       render.library. Now it closes down gently (It seems as I was
  305.       completely brain-dead when I wrote the setup routine)
  306.     - autodocs now reflect all new tags and methods.
  307.  
  308. v1.99
  309.     - since the autodither value cannot be computed when rendering
  310.       to HAM screen modes, HAM dithering is always enabled with
  311.       autodither != 0 and disabled with autodither==0.
  312.     - fixed documentation of AddPaletteA() and fixed a bug in
  313.       AddPalette() / PALFMT_RGB32. Thanks to Frank Pagels who
  314.       reported these problems.
  315.     - added picture method PICMTHD_TINT.
  316.     - guigfx.library no longer tries to open Cybergraphics.library
  317.       v41. The code now correctly differentiates for ScalePixelArray()
  318.       and custom scaling routines. Thanks to M. Hillenbrand and
  319.       S. Sommerfeld who reported this bug.
  320.  
  321. v1.98
  322.     - drawing/scaling truecolor to truecolor drawing is now
  323.       done with ScalePixelArray/cybergraphics.library which
  324.       isn't as slow as I expected. It can stand the test
  325.       with a render.library scaling-engine plus line-by-line
  326.       drawing, and it requires no additional memory.
  327.     - The code now differenciates graphics v40 for drawing to
  328.       graphic card rastports via WriteChunkyPixels().
  329.  
  330. v1.97
  331.     - guigfx.library now tries to convert chunky pictures to
  332.       truecolor before drawing to HAM modes. if conversion
  333.       fails (i.e. with the picture in a static buffer), the
  334.       image will be drawn with the 16/64 HAM base colors.
  335.  
  336. v1.96
  337.     - fixed a minor bug that occured when drawing odd-width
  338.       pictures in directdraw mode.
  339.     - guigfx.library now renders to HAM modes. Currently the
  340.       full HAM spectrum is only used with truecolor pictures.
  341.       When ObtainDrawHandle() is supplied with GGFX_ModeID, 
  342.       then HAM is automatically recognized and used.
  343.  
  344. v1.95
  345.     - removed a workaround for an incompatibility problem
  346.       between the cybergraphx and picasso96 picture.datatypes.
  347.       loading is faster now and requires less memory. this
  348.       update requires the picasso96 picture.class datatype
  349.       v43.26.
  350.     - revised autodocs and completed the documentation for
  351.       the picture method PICMTHD_CREATEALPHAMASK.
  352.  
  353. v1.94
  354.     - fixed a overlap-memcopy bug in PICMTHD_CROP. You need to
  355.       upgrade to render.library v22.1.
  356.  
  357. v1.93
  358.     - improved alpha-channel handling. PICMTHD_MIXALPHA
  359.       now handles alpha-channels in both the source and
  360.       destination picture (if present).
  361.     - implemented PICMTHD_CREATEALPHAMASK.
  362.     - added E includes
  363.  
  364. v1.92
  365.     - fixed bug in DoPictureMethod: certain internal format
  366.       conversions lead to crashes since v1.7.
  367.     - implemented PICMTHD_RENDER with destination format
  368.       PIXFMT_RGB_24.
  369.     - completed alpha-channel administration. an alpha-channel
  370.       is no longer discarded when the internal pixel format
  371.       changes.
  372.     - implemented GGFX_AlphaPresent for MakePicture()
  373.  
  374. v1.9
  375.     - rewrote all drawing routines. the code is more
  376.       differentiated for optimized drawing.
  377.     - autodither fixed. finally this feature works as
  378.       it was originally intended to.
  379.     - Fixed v1.8 bug when drawing to truecolor screens.
  380.     - implemented GGFX_DitherMode for DrawPicture() and
  381.       CreatePictureBitMap(). They may be used to optionally
  382.       override the drawhandle's dithermode.
  383.     - Note: guigfx.library v1.9 requires render.library v21.
  384.     - implemented GGFX_AspectX and GGFX_AspectY to
  385.       MakePicture().
  386.  
  387. v1.8
  388.     - ObtainDrawHandle() no longer allocates pens for
  389.       truecolor rastports. Thanks to Stefan Sommerfeld
  390.       who reported this bug.
  391.     - GGFX_SourceWidth and GGFX_SourceHeight were not
  392.       correctly implemented for CreatePictureBitMap()
  393.     - fixed minor memory transfer problems: TurboCopyMem()
  394.       was sometimes applied to odd-sized memory areas
  395.     - implemented GGFX_BufferSize for MakePicture()
  396.  
  397. v1.7
  398.     - a picture has no longer to be maintained for an open
  399.       colorhandle. with other words: you may DeletePicture()
  400.       a picture after it has been added to a pensharemap via
  401.       AddPicture().
  402.     - implemented GGFX_MaxAllocPens for ObtainDrawHandle().
  403.       This limits the number of allocated pens to a specific
  404.       number. Better you use this feature only if you've got
  405.       a very good reason for it.
  406.     - math problems fixed. GGFX_Weight should work now. a better
  407.       color allocation strategy has been implemented.
  408.       Currently use GGFX_Weight in a range from 1-10. Maybe
  409.       I will implement a more sophisticated measurement later.
  410.     - internal color allocation order is now PALMODE_SATURATION
  411.       instead of PALMODE_SIGNIFICANCE. this improves color
  412.       allocation speed drastically.
  413.     - drawhandles no longer maintain a global mapping-engine.
  414.       this saves some memory and is remarkably faster in many
  415.       situations, since the mapping-engine could not be linked
  416.       to the drawhandle's histogram.
  417.  
  418. v1.6
  419.     - implemented GGFX_ErrorCode for LoadPicture(). You specify
  420.       a pointer to LONG, and a standard DOS error code will be
  421.       returned (NULL when everything was OK).
  422.  
  423. v1.5
  424.     - LoadPicture() did not always handle v43 bitmaps correctly.
  425.       Fixed. Thanks to Markus Hillenbrand who reported this bug.
  426.     - guigfx.library's global memhandler is reset to RMHTYPE_PUBLIC
  427.       for debugging, since public memory violations can be
  428.       tracked down more easily.
  429.     - fixed PICMTHD_MIXALPHA with the source picture in
  430.       PIXFMT_CHUNKY_CLUT
  431.     - added PICATTR_AspectX and PICATTR_AspectY to GetPictureAttrs()
  432.  
  433. v1.4    - fixed minor autodither bug.
  434.     - GGFX_CallBackHook implemented for CreatePictureBitMap.
  435.     - the autodither calculation is now invoked only for rastports
  436.       with a depth <= 8
  437.  
  438. v1.3
  439.     - added GGFX_DitherMode to CreatePictureBitMap()
  440.     - added GGFX_DestWidth, DestHeight, DestX and DestY to
  441.       method PICMTHD_MIXALPHA and PICMTHD_SETALPHA.
  442.       added GGFX_DestWidth, DestHeight, DestX, DestY, SourceX,
  443.       SourceY, SourceWidth, SourceHeight to method PICMTHD_MIX.
  444.       after all, DoPictureMethod() can apply clip regions of alpha
  445.       channel data to regions inside the picture, with automatic
  446.       scaling when necessary.
  447.     - cleaned up all drawing routines.
  448.     - GGFX_CallBackHook implemented for DrawPicture.
  449.  
  450. v1.2
  451.     - fixed a bug in ClonePicture(). When a cloned picture was
  452.       deleted after the original, a memhandler-failure occured
  453.       (leading to an ILLEGAL exception in render.library)
  454.     - fixed a bug in LoadPicture() - eliminated calls to IoErr().
  455.       dos.library is not part of guigfx.library. this fixes
  456.       crashes with unknown datatype objects or load errors.
  457.     - guigfx.library now uses a global memhandler with RMHTYPE_POOL
  458.       and MEMF_REVERSE.
  459.     - implemented GGFX_SourceWidth, GGFX_SourceHeight, GGFX_SourceX
  460.       and GGFX_SourceY for DrawPicture(). Now you can easily specify
  461.       offsets.
  462.  
  463. v1.1
  464.     - fixed a heavy bug when drawing to native Amiga screen modes.
  465.  
  466.  
  467. v1.0
  468.     - first internal beta release.
  469.  
  470.